home *** CD-ROM | disk | FTP | other *** search
/ Aminet 32 / Aminet 32 (1999)(Schatztruhe)[!][Aug 1999].iso / Aminet / dev / lang / Python152.lha / Python-1.5 / README < prev    next >
Text File  |  1999-04-30  |  6KB  |  176 lines
  1.  
  2.  
  3.                                PYTHON 1.5.2
  4.                           NOTES ON THE AMIGA PORT
  5.  
  6.                               April 30, 1999.
  7.  
  8.     
  9.            Conversion and Amiga specific code by Irmen de Jong.
  10.               (Original code by Guido van Rossum and others)
  11.  
  12.  
  13.  
  14.                    Read the file <DISCL_and_COPYRIGHT>!
  15.  
  16.    It contains the disclaimer for this software, and copyright notices.
  17.  
  18.  
  19.  
  20.     Contents:
  21.     ~~~~~~~~~
  22.  
  23.     1. What's new?    
  24.     2. General remarks.
  25.     3. Troubleshooting.
  26.     4. Thanks.
  27.  
  28.  
  29. +----------------------+
  30. |                      |
  31. |  1. What's new?      |
  32. |                      |
  33. +----------------------+
  34.  
  35. IMPORTANT CHANGES SINCE THE PREVIOUS VERSION (version 1.5.1 build 18):
  36.  
  37.     - Based on the official 1.5.2 sources and library.
  38.       1.5.1 will be phased out. I won't release updates for 1.5.1 anymore.
  39.  
  40.  
  41. +----------------------+
  42. |                      |
  43. |  2. General remarks  |
  44. |                      |
  45. +----------------------+
  46.  
  47. * The MAIN PYTHON SITE is <http://www.python.org>. All general documentation
  48.   can be obtained from here (Python tutorial, language reference, library
  49.   reference and much more).
  50.  
  51. * The above mentioned documentation is also available on Aminet, as
  52.   dev/lang/Python152_Doc.lha.
  53.  
  54. * The AmigaPython homepage is at http://www.bigfoot.com/~irmen/python.html
  55.   (note the new address!). Check it out for news, future plans, bugs etc.
  56.   You can also obtain the beta I-Net 225 version here.
  57.  
  58. * In the `Docs/Amiga' directory you can find the docs for the Amiga specific
  59.   modules and features. Read them, they contain vital information!
  60.  
  61. * The Python library contains an extensive test set.
  62.   To try it yourself, type (after installation):
  63.     Python -c "import test.autotest" (and have patience...)
  64.     Python -c "import test.autotest" (and have patience...)
  65.   (Yes: do it TWICE because the generated .pyc files need to be checked too).
  66.   (You can also start the RunTest.py script from the Workbench).
  67.   Some tests cannot run on the Amiga - they will be skipped.
  68.   The report at the end should say something like:
  69.     31 tests OK.
  70.     18 tests skipped:  .....
  71.   If you don't start AmiTCP first, test_socket and test_select will fail.
  72.   If usergroup.library cannot be opened, crypt, grp and pwd will fail.
  73.  
  74. * To  see  some  command  line  options,  use  the -?  option, or any other
  75.   unrecognised option.
  76.  
  77. * To run a speed benchmark, type:
  78.     Python -c "import test.pystone; test.pystone.main()"
  79.   and have some patience. On my system, I get 366 pystones/second.
  80.  
  81. * In the `Icons' directory there are some icon suggestions.
  82.   def_py.info is an icon for Python source files (.py)
  83.   def_pyc.info is an icon for Pytnon bytecode files (.pyc)
  84.  
  85. * The following modules are built-in in this release:
  86.     ARexxll        Doslib        amiga        array
  87.     binascii    cPickle        cStringIO    cmath
  88.     crypt        environment    errno        grp
  89.     imp        marshal        math        md5
  90.     new        operator    pcre        pwd
  91.     regex        rotor        select        sha
  92.     socket        soundex        strop        struct
  93.     sys        syslog        time
  94.  
  95.   Amiga specific: amiga, ARexxll, Doslib, environment
  96.   Needs usergroup.library: crypt, grp, pwd.
  97.   Needs AmiTCP's bsdsocket.library: select, socket, syslog.
  98.  
  99. * Mail  me  if  you encounter any Amiga specific problems, or if you have any
  100.   Amiga  related  questions  about  Python,  or  just  for fun.  General
  101.   questions are better asked on the usenet newsgroup comp.lang.python.  A lot
  102.   of   information,   including  an  online  manual,  can  be  obtained  from
  103.   <http://www.python.org/>. Read the FAQ before asking!
  104.  
  105.  
  106. +-----------------------+
  107. |                       |
  108. |  3. Troubleshooting   |
  109. |                       |
  110. +-----------------------+
  111.  
  112. * When  I  try  to  install  Python,  I  get  "Unable  to  open  your tool
  113.   'installer'"!
  114.  
  115.   The Installer® utility is required for installation, but it is not included
  116.   in  the  archive.   Get  it  from  somewhere  else  and  copy it to your C:
  117.   directory or somewhere where Workbench can find it.
  118.  
  119. * When I start python, I get "This program requires a math co-processor"!
  120.  
  121.   You should upgrade your computer to at least a 68030 with a FPU.
  122.  
  123. * I   get   "Couldn't   open   bsdsocket.library"   or   "Couldn't   open
  124.   usergroup.library" errors!
  125.  
  126.   You  are  trying to use functions that need one of these libraries.  AmiTCP
  127.   is required if you want to use all (network) functions.
  128.  
  129. * Python crashes when executing complex (recursive) code!
  130.  
  131.   This should not happen; you should get a MemoryError exception.  If it does
  132.   crash, increase your stack size and try again.  Python's default stack size
  133.   is 20K, which should be enough for most programs.
  134.  
  135. * Functions which use the PIPE: device (like os.popen) seem to work
  136.   incorrectly!
  137.  
  138.   The default l:queue-handler is buggy.  Make sure you have installed a fixed
  139.   l:queue-handler (I'm using util/sys/HWGQueue.lha from Aminet)
  140.  
  141. * I cannot import Dos or ARexx!
  142.  
  143.   Try `import site' first.
  144.  
  145. * Other errors
  146.  
  147.   Mail me at irmen@bigfoot.com with a clear description of the problem.
  148.  
  149.  
  150. +-----------------------+
  151. |                       |
  152. |  4. Thanks            |
  153. |                       |
  154. +-----------------------+
  155.  
  156. Ofcourse this product could never have happened without the support of various
  157. people. Amongst others I'd like to thank:
  158.  
  159. Guido van Rossum - for creating Python in the first place
  160. Mike Meyer for his various suggestions and problem reports
  161. Kent Polk for his various suggestions and problem reports
  162. Lyster E. Wick for his various contributions (NewIcons/ARexx/WB/bugreports)
  163.  
  164. and my friends who supported me in the first phase of this project (that
  165. was LONG ago, in the Python 1.2 days).
  166.  
  167. If you think your name is missing here, drop me a line.
  168.  
  169. Every AmigaPython user out there, thanks for your interest!
  170.  
  171.  
  172.  
  173.  
  174.                     Irmen de Jong
  175.                     (irmen@bigfoot.com)
  176.